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CHAPTER  1 
INTRODUCTION 


The  Ada  implementation  described  above  was  tested  according  to  the  Ada  Validation  Procedures 
[Pro90]  against  the  Ada  Standard  [Ada83]  using  the  current  Ada  Compiler  Validation  Capability 
(ACVC).  This  Validation  Summary  Report  (VSR)  gives  an  account  of  the  testing  of  this  Ada 
implementation.  For  any  technical  terms  used  in  this  report,  the  reader  is  referred  to  [Pro90].  A 
detailed  description  of  the  ACVC  may  be  found  in  the  current  ACVC  User’s  Guide  [UG89]. 


1.1  USE  OF  THIS  VALIDATION  SUMMARY  REPORT 

Consistent  with  the  national  laws  of  the  originating  country,  the  Ada  Certification  Body  may  make 
full  and  free  public  disclosure  of  this  report.  In  the  United  States,  this  is  provided  in  accordance  with 
the  "Freedom  of  Information  Act"  (5  U.S.C.  #552).  The  results  of  this  validation  apply  only  to  the 
computers,  operating  systems,  and  compiler  versions  identified  in  this  report. 

The  organizations  represented  on  the  signature  page  of  this  report  do  not  represent  or  warrant  that 
all  statements  set  forth  in  this  report  are  accurate  and  complete,  or  that  the  subject  implementation 
has  no  nonconformities  to  the  Ada  Standard  other  than  those  presented.  Copies  of  this  report  are 
available  to  the  public  from  the  AVF  which  performed  this  validation  or  from: 

National  Technical  Information  Service 
5285  Port  Royal  Road 
Springfield  VA  22161 

Questions  regarding  this  report  or  the  validation  test  results  should  be  directed  to  the  AVF  which 
performed  this  validation  or  to: 

Ada  Validation  Organization 

Computer  and  Software  Engineering  Division 

Institute  for  Defense  Analyses 

1801  North  Beauregard  Street 

Alexandria  VA  22311-1772 

1.2  REFERENCES 

[Ada83]  Reference  Manual  for  the  Ada  Programming  Language. 

ANSI/MIL-STD-  1815A,  February  1983  and  ISO  8652-1987. 

[Pro90]  Ada  Compiler  Validation  Procedures. 

Version  2.1,  Ada  Joint  Program  Office,  August  1990. 
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[UG89]  Ada  Compiler  Validation  Capability  User’s  Guide. 

21  June  1989. 


1.3  A CVC  TEST  CLASSES 

Compliance  of  Ada  implementations  is  tested  by  means  of  the  A  CVC.  The  ACVC  contains  a 
collection  of  test  programs  structured  into  six  test  classes:  A,  B,  C,  D,  E,  and  L.  The  first  letter  of  a 
test  name  identifies  the  class  to  which  it  belongs.  Class  A,  C,  D,  and  E  tests  are  executable.  Class  B 
and  class  L  tests  are  expected  to  produce  errors  at  compile  time  and  link  time,  respectively. 

The  executable  tests  are  written  in  a  self-checking  manner  and  produce  a  PASSED,  FAILED,  or 
NOT  APPLICABLE  message  indicating  the  result  when  they  are  executed.  Three  Ada  library  units, 
the  packages  REPORT  and  SPPRT13,  and  the  procedure  CHECK_FILE  are  used  for  this  purpose. 
The  package  REPORT  also  provides  a  set  of  identity  functions  used  to  defeat  some  compiler 
optimizations  allowed  by  the  Ada  Standard  that  would  circumvent  a  test  objective.  The  package 
SPPRT13  is  used  by  many  tests  for  Chapter  13  of  the  Ada  Standard.  The  procedure  CHECK_FILE 
is  used  to  check  the  contents  of  text  files  written  by  some  of  the  Class  C  tests  for  Chapter  14  of  the 
Ada  Standard.  The  operation  of  REPORT  and  CHECK_FILE  is  checked  by  a  set  of  executable  tests. 
If  these  units  are  not  operating  correctly,  validation  testing  is  discontinued. 

Class  B  tests  check  that  a  compiler  detects  illegal  language  usage.  Class  B  tests  are  not  executable. 
Each  test  in  this  class  is  compiled  and  the  resulting  compilation  listing  is  examined  to  verify  that  all 
violations  of  the  Ada  Standard  are  detected.  Some  of  the  class  B  tests  contain  legal  Ada  code  which 
must  not  be  flagged  illegal  by  the  compiler.  This  behaviour  is  also  verified. 

Class  L  tests  check  that  an  Ada  implementation  correctly  detects  violation  of  the  Ada  Standard 
involving  multiple,  separately  compiled  units.  Errors  are  expected  at  link  time,  and  execution  is 
attempted. 

In  some  tests  of  the  ACVC,  certain  macro  strings  have  to  be  replaced  by  implementation-specific 
values  -  for  example,  the  largest  integer.  A  list  of  the  values  used  for  this  implementation  is  provided 
in  Appendix  A.  In  addition  to  these  anticipated  test  modifications,  additional  changes  may  be  required 
to  remove  unforeseen  conflicts  between  the  tests  and  implementation-dependent  characteristics.  The 
modifications  required  for  this  implementation  are  described  in  section  2.3. 

For  each  Ada  implementation,  a  customized  test  suite  is  produced  by  the  AVF.  This  customization 
consists  of  making  the  modifications  described  in  the  preceding  paragraph,  removing  withdrawn  tests 
(see  section  2.1),  and  possibly  removing  some  inapplicable  tests  (see  section  2.2  and  [UG89]). 

In  order  to  pass  an  ACVC  an  Ada  implementation  must  process  each  test  of  the  customized  test  suite 
according  to  the  Ada  Standard. 
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1.4  DEFINITION  OF  TERMS 


Ada  Compiler 


Ada  Compiler 
Validation  Capability 
(ACVC) 

Ada  Implementation 


Ada  Joint  Program 
Office  (AJPO) 

Ada  Validation  Facility 
(AVF) 

Ada  Validation 
Organization  (AVO) 

Compliance  of  an  Ada 
Implementation 

Computer  System 


Conformity 

Customer 


Declaration  of 
Conformance 


Host  Computer  System 


The  software  and  any  needed  hardware  that  have  to  be  added  to  a  given 
host  and  target  computer  system  to  allow  transformation  of  Ada 
programs  into  executable  form  and  execution  thereof. 

The  means  for  testing  compliance  of  Ada  implementations,  consisting  of 
the  test  suite,  the  support  programs,  the  ACVC  user’s  guide  and  the 
template  for  the  validation  summary  report. 

An  Ada  compiler  with  its  host  computer  system  and  its  target  computer 
system. 

The  part  of  the  certification  body  which  provides  policy  and  guidance  for 
the  Ada  certification  system. 

The  part  of  the  certification  body  which  carries  out  the  procedures 
required  to  establish  the  compliance  of  an  Ada  implementation. 

The  part  of  the  certification  body  that  provides  technical  guidance  for 
operations  of  the  Ada  certification  system. 

The  ability  of  the  implementation  to  pass  an  ACVC  version. 


A  functional  unit,  consisting  of  one  or  more  computers  and  associated 
software,  that  uses  common  storage  for  all  or  part  of  a  program  and  also 
for  all  or  part  of  the  data  necessary  for  the  execution  of  the  program; 
executes  user-written  or  user-designated  programs;  performs  user- 
designated  date  manipulation,  including  arithmetic  operations  and  logic 
operations;  and  that  can  execute  programs  that  modify  themselves  during 
execution.  A  computer  system  may  be  a  stand-alone  unit  or  may  consist 
of  several  inter-connected  units. 

Fulfilment  of  a  product,  process  or  service  of  all  requirements  specified. 

An  individual  or  corporate  entity  who  enters  into  an  agreement  with  an 
AVF  which  specifies  the  terms  and  conditions  for  AVF  services  (of  any 
kind)  to  be  performed. 

A  formal  statement  from  a  customer  assuring  that  conformity  is  realized 
or  attainable  on  the  Ada  implementation  for  which  validation  status  is 
realized. 

A  computer  system  where  Ada  source  programs  are  transformed  into 
executable  form. 
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Inapplicable  test 

ISO 

LRM 

Operating  System 

Target  Computer 
System 

Validated  Ada  Compiler 

Validated  Ada 
Implementation 

Validation 

Withdrawn  test 


A  test  that  contains  one  or  more  test  objectives  found  to  be  irrelevant  for 
the  given  Ada  implementation. 

International  Organization  for  Standardization. 

The  Ada  standard,  or  Language  Reference  Manual,  published  as 
ANSI/MIL-STD-1815A-1983  AND  ISO  8652-1987.  Citations  from  the 
LRM  take  the  form  "<section>.<subsection>:<paragraph>." 

Software  that  controls  the  execution  of  programs  and  that  provides 
services  such  as  resource  allocation,  scheduling,  input/output  control  and 
data  management.  Usually,  operating  systems  are  predominantly 
software,  but  partial  or  complete  hardware  implementations  are  possible. 

A  computer  system  where  the  executable  form  of  Ada  programs  are 
executed. 

The  compiler  of  a  validated  Ada  implementation. 

An  Ada  implementation  that  has  been  validated  successfully  either  by 
AVF  testing  or  by  registration  [Pro90]. 

The  process  of  checking  the  conformity  of  an  Ada  compiler  to  the  Ada 
programming  language  and  of  issuing  a  certificate  for  this 
implementation. 

A  test  found  to  be  incorrect  and  not  used  in  conformity  testing.  A  test 
may  be  incorrect  because  it  has  an  invalid  test  objective,  fails  to  meet  its 
test  objective,  or  contains  erroneous  or  illegal  use  of  the  Ada 
programming  language. 
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CHAPTER  2 

IMPLEMENTATION  DEPENDENCIES 


2.1  WITHDRAWN  TESTS 

The  following  tests  have  been  withdrawn  by  the  AVO.  The  rationale  for  withdrawing  each  test  is 
available  from  either  the  AVO  or  the  AVF.  The  publication  date  for  this  list  of  withdrawn  tests  is  2 
August  1991. 


E28005C 

B28006C 

C32203A 

C34006D 

C35508I 

C35508J 

C35508M 

C35508N 

C35702A 

C35702B 

B41308B 

C43004A 

C45114A 

C45346A 

C45612A 

C45612B 

C45612C 

C45651A 

C46022A 

B49008A 

B49008B 

A74006A 

C74308A 

B83022B 

B83022H 

B83025B 

B83025D 

C83026A 

B83026B 

C83041A 

B85001L 

C86001F 

C94021A 

C97116A 

C98003B 

BA2011A 

CB7001A 

CB7001B 

CB7004A 

CC1223A 

BC1226A 

CC1226B 

BC3009B 

BD1B02B 

BD1B06A 

AD1B08A 

BD2A02A 

CD2A21E 

CD2A23E 

CD2A32A 

CD2A41A 

CD2A41E 

CD2A87A 

CD2B15C 

BD3006A 

BD4008A 

CD4022A 

CD4022D 

CD4024B 

CD4024C 

CD4024D 

CD4031A 

CD4051D 

CD5111A 

CD7004C 

ED7005D 

CD7005E 

AD7006A 

CD7006E 

CD7104B 

AD7201A 

AD7201E 

AD7206A 

BD8002A 

BD8004C 

CD9005A 

CD9005B 

CDA201E 

CE2107I 

CE2117A 

CE2117B 

CE2119B 

CE2205B 

CE2405A 

CE3111C 

CE3116A 

CE3118A 

CE3411B 

CE3412B 

CE3607B 

CE3607C 

CE3607D 

CE3812A 

CE3814A 

CE3902B 

2.2  INAPPLICABLE  TESTS 

A  test  is  inapplicable  if  it  contains  test  objectives  which  are  irrelevant  for  a  given  Ada 
implementation.  Reasons  for  a  test’s  inapplicability  may  be  supported  by  documents  issued  by  the  ISO 
and  the  AJPO  known  as  Ada  Commentaries  and  commonly  referenced  in  the  format  Al-ddddd.  For 
this  implementation,  the  following  tests  were  determined  to  be  inapplicable  for  the  reasons  indicated; 
references  to  Ada  Commentaries  are  included  as  appropriate. 


C24113I..N  (6  tests)  allow  source  lines  with  134  characters.  This  implementation  does  not  support 
such  a  length. 

The  following  159  tests  have  floating-point  type  declarations  requiring  more  digits  than 
SYSTEM.MAXJDIGITS: 

C241130..Y  (11  tests)  C35705O..Y  (11  tests) 

C35706O..Y  (11  tests)  C35707O..Y  (11  tests) 

C35708O..Y  (11  tests)  C35802O..Z  (12  tests) 
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C452410..Y  (11  tests) 
C454210..Y  (11  tests) 
C455240..Z  (12  tests) 
C456410..Y  (11  tests) 


C453210..Y  (11  tests) 
C455210..Z  (12  tests) 
C456210..Z  (12  tests) 
C46012O..Z  (12  tests) 


The  following  21  tests  check  for  the  predefined  type  SHORT_INTEGER;  for  this  implementation, 
there  is  no  such  type: 


C35404B 

B36105C 

C45231B 

C45304B 

C45411B 

C45412B 

C45502B 

C45503B 

C45504B 

C45504E 

C4561IB 

C45613B 

C45614B 

C45631B 

C45632B 

B52004E 

C55B07B 

B55B09D 

B86001V 

C86006D 

CD7101E 


C35404D,  C45231D,  B86001X,  C86006E,  and  CD7101G  check  for  a  predefined  integer  type  with  a 
name  other  than  INTEGER,  LONG_INTEGER,  or  SHORT_INTEGER;  for  this  implementation, 
there  is  no  such  type. 

C35713D  and  B86001Z  check  for  a  predefined  floating-point  type  with  a  name  other  than  FLOAT, 
LONG_FLOAT,  or  SHORT  FLOAT;  for  this  implementation,  there  is  no  such  type. 

C45423A..B  (2  tests),  C45523A,  and  C45622A  check  that  the  proper  exception  is  raised  if 
MACHINE  OVERFLOWS  is  TRUE  and  the  results  of  various  floating-point  operations  lie  outside 
the  range  of  the  base  type;  for  this  implementation,  MACHINE_OVERFLOWS  is  FALSE. 

B86001Y  uses  the  name  of  a  predefined  fixed-point  type  other  than  type  DURATION;  for  this 
implementation,  there  is  no  such  type. 

C96005B  uses  values  of  type  DURATION'S  base  type  that  are  outside  the  range  of  type 
DURATION;  for  this  implementation,  the  ranges  are  the  same. 

CA2009C  and  CA2009F  are  not  applicable  because  the  implementation  requires  that  generic  unit 
bodies  be  compiled  together  with  their  specifications. 

LA3004A..B,  EA3004C..D,  and  CA3004E..F  (6  tests)  check  pragma  INLINE  for  procedures  and 
functions;  this  implementation  does  not  support  pragma  INLINE. 

CD1009C  checks  whether  a  length  clause  can  specify  a  non-default  size  for  a  floating-point  type;  this 
implementation  does  not  support  such  sizes. 

CD2A84A,  CD2A84E,  CD2A84I.  J  (2  tests),  and  CD2A840  use  length  clauses  to  specify  non-default 
sizes  for  access  types;  this  implementation  does  not  support  such  sizes. 

CD2B15B  checks  that  STORAGE_ERROR  is  raised  when  the  storage  size  specified  for  a  collection 
is  too  small  to  hold  a  single  value  of  the  designated  type;  this  implementation  allocates  more  space 
than  was  specified  by  the  length  clause,  as  allowed  by  AI -00558, 
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BD8001A,  BD8003A,  BD8004A..B  (2  tests),  and  AD801IA  use  machine  code  insertions;  this 
implementation  provides  no  package  MACHINE_CODE. 

AE2I01C  and  EE2201D..E  (2  tests)  are  instantiations  of  package  SEQUENTIAL_IO  with 
unconstrained  array  types  and  record  types  with  discriminants  without  defaults;  these  instantiations 
are  rejected  by  this  compiler. 

AE2101H,  EE2401D,  and  EE2401G  use  instantiations  of  package  DIRECT_IO  with  unconstrained 
array  types  and  record  types  with  discriminants  without  defaults;  these  instantiations  are  rejected  by 
this  compiler. 

The  tests  listed  in  the  following  table  check  that  USE_ERROR  is  raised  if  the  given  file  operations 
are  not  supported  for  the  given  combination  of  mode  and  access  method;  this  implementation 
supports  these  operations. 


Test 

File  Operation 

Mode 

File  Access  Method 

CE2102D 

CREATE 

IN  FILE 

SEQUENTIAL  IO 

CE2I02E 

CREATE 

OUT  FILE 

SEQUENTIAL  IO 

CE2102F 

CREATE 

INOUT  FILE  DIRECT  IO 

CE2102I 

CREATE 

IN  RLE 

DIRECT  IO 

CE2102J 

CREATE 

OUT  RLE 

DIRECT  IO 

CE2102N 

OPEN 

IN  FILE 

SEQUENTIAL  IO 

CE2102O 

RESET 

IN  RLE 

SEQUENTIAL  IO 

CE2102P 

OPEN 

OUT  FILE 

SEQUENTIAL  IO 

CE2102Q 

RESET 

OUT  RLE 

SEQUENTIAL  IO 

CE2I02R 

OPEN 

INOUT  FILE  DIRECT  IO 

CE2102S 

RESET 

INOUT  RLE  DIRECT  IO 

CE2102T 

OPEN 

IN  FILE 

DIRECT  IO 

CE2102U 

RESET 

IN  FILE 

DIRECT  IO 

CE2102V 

OPEN 

OUT  FILE 

DIRECT  IO 

CE2102W 

RESET 

OUT  RLE 

DIRECT  IO 

CE3I02E 

CREATE 

IN  FILE 

TEXT  IO 

CE3102F 

RESET 

Any  Mode 

TEXT  IO 

CE3102G 

DELETE 

— 

TEXT  IO 

CE3102I 

CREATE 

OUT  RLE 

TEXT  IO 

CE3102J 

OPEN 

in.fTle 

TEXT  IO 

CE3102K 

OPEN 

OUT  FILE 

TEXT  IO 

The  test  listed  in  the  following  table  checks  the  given  file  operation  for  the  given  combination  of 
mode  and  access  method;  this  implementation  does  not  support  this  operation. 


Test  File  Operation  Mode  File  Access  Method 


CE2I11C  RESET  OUT_FILE  SEQUENT  lAL_IO 
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The  following  16  tests  check  operations  on  sequential,  direct  and  text  Hies  when  multiple  internal  files 
are  associated  with  the  same  external  file  and  one  or  more  are  open  for  writing:  USE_ERROR  is 
raised  when  this  association  is  attempted. 

CE2107B..E  CE2107G..H  CE2107L  CE2110B  CE2110D 

CE2111D  CE2111H  CE3111B  CE3111D..E  CE3114B 

CE3115A 

CE2203A  checks  that  WRITE  raises  USE_ERROR  if  the  capacity  of  an  external  sequential  file  is 
exceeded;  this  implementation  cannot  restrict  file  capacity. 

CE2403A  checks  that  WRITE  raises  USE_ERROR  if  the  capacity  of  an  external  direct  file  is 
exceeded;  this  implementation  cannot  restrict  file  capacity. 

2.3  TEST  MODIFICATIONS 

Modifications  (see  section  1.3)  were  required  for  63  tests. 

The  following  tests  were  split  into  two  or  more  tests  because  this  implementation  did  not  report  the 
violations  of  the  Ada  Standard  in  the  way  expected  by  the  original  tests. 


B26005A 

B37301B 

B38009B 

B61001I 

B83A07A 

B83E01E 

B91002B 

B91002G 

B91002L 

B95077A 

BC1109C 

BC1202G 


B38003A 

B37302A 

B55A01A 

B61001M 

B83A07B 

B85001D 

B91002C 

B91002H 

B95030A 

B97103E 

BC1109D 

BD2A25A 


B29001A 

B38003A 

B61001C 

B61001R 

B83A07C 

B85008D 

B91002D 

B91002I 

B95061A 

B97104G 

BC1202A 

BE2210A 


B35101A 

B38003B 

B61001F 

B61001W 

B83E01C 

B91001A 

B91002E 

B91002J 

B95061F 

BA1001A 

BC1202E 

BE2413A 


B37106A 

B38009A 

B61001H 

B67001H 

B83E01D 

B91002A 

B91U02F 

B91002K 

B95061G 

BA1101B 

BC1202F 


C64103A  and  C95084A  were  graded  passed  by  Evaluation  Modification  as  directed  by  the  AVO. 
Because  this  implementation’s  actual  values  for  LONGFLOAT’SAFELARGE  and 
SHORT_FLOAT’LAST  lie  within  one  (SHORT_FLOAT)  model  interval  of  each  other,  the  tests’ 
floating-point  applicability  check  may  evaluate  to  TRUE  and  yet  the  subsequent  expected  exception 
need  not  be  raised.  The  AVO  ruled  that  the  implementation’s  behaviour  should  be  graded  as  passed 
because  the  implementation  passed  the  integer  and  fixed-point  checks;  the  following 
REPORT.FAILED  messages  were  produced  after  the  type  conversions  at  line  198  in  C64103A  and 
lines  101  and  250  in  C95084A  failed  to  raise  exceptions: 

C64103A:  "EXCEPTION  NOT  RAISED  AFTER  CALL  -P2  (B)" 

C95084A:  "EXCEPTION  NOT  RAISED  BEFORE  CALL  -  T2  (A)" 
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"EXCEPTION  NOT  RAISED  AFTER  CALL  -  T5  (B)B 


C83030C  and  C86007A  were  graded  passed  by  Test  Modification  as  directed  by  the  AVO.  These  tests 
were  modified  by  inserting  "PRAGMA  ELABORATE  (REPORT);"  before  the  package  declarations 
at  lines  13  and  11,  respectively.  Without  the  pragma,  the  packages  may  be  elaborated  prior  to  package 
Report’s  body,  and  thus  the  packages’  calls  to  function  REPORT.IDENT_INT  at  lines  14  and  13, 
respectively,  will  raise  PROGRAM_ERROR. 
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CHAPTER  3 

PROCESSING  INFORMATION 

3.1  TESTING  ENVIRONMENT 


The  Ada  implementation  tested  in  this  validation  effort  is  described  adequately  by  the  information 
given  in  the  initial  pages  of  this  report  together  with  the  following: 

The  Memory  Size  of  the  Host/Target  Configuration  is  64  Mbytes. 

For  technical  information  about  this  Ada  implementation,  contact: 

Christine  Saunders 

International  Computers  Limited 

Eskdale  Road 

Winnersh 

Wokingham 

Berkshire 

RG11  5TT 

Testing  of  this  Ada  implementation  was  conducted  at  the  customer’s  site  by  a  validation  team  from 
the  AVF. 

3.2  SUMMARY  OF  TEST  RESULTS 

An  Ada  Implementation  passes  a  given  ACVC  version  if  it  processes  each  test  of  the  customized  test 
suite  in  accordance  with  the  Ada  Programming  Language  Standard,  whether  the  test  is  applicable  or 
inapplicable;  otherwise,  the  Ada  Implementation  fails  the  ACVC  [Pro90]. 

For  all  processed  tests  (inapplicable  and  applicable),  a  result  was  obtained  that  conforms  to  the  Ada 
Programming  Language  Standard.  * 

The  list  of  items  below  gives  the  number  of  ACVC  tests  in  various  categories.  All  tests  were 
processed,  except  those  that  were  withdrawn  because  of  test  errors  (item  b;  see  section  2.1),  those 
that  require  a  floating-point  precision  that  exceeds  the  implementation’s  maximum  precision  (item 
e;  see  section  2.2),  and  those  that  depend  on  the  support  of  a  file  system  -  if  none  is  supported  (item 
d).  All  tests  passed,  except  those  that  are  listed  in  sections  2.1  and  2.2  (counted  in  items  b  and  f, 
below). 


a) 

Total  Number  of  Applicable  Tests 

3810 

b) 

Total  Number  of  Withdrawn  Tests 

95 

c) 

Processed  Inapplicable  Tests 

265 
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d)  Non-Processed  I/O  Tests  0 

e)  Non-Processed  Floating-Point  Precision  Tests  0 

f)  Total  Number  of  Inapplicable  Tests  265  (c+d+e) 

g)  Total  Number  of  Tests  for  ACVC  1.11  4170  (a+b+f) 


3.3  TEST  EXECUTION 

A  set  of  magnetic  tapes  containing  the  customized  test  suite  (see  section  1.3)  was  taken  on-site  by 
the  validation  team  for  processing.  The  contents  of  the  magnetic  tapes  were  loaded  directly  onto  the 
host  computer. 

After  the  test  files  were  loaded  onto  the  host  computer,  the  full  set  of  tests  was  processed  by  the  Ada 
implementation. 

Testing  was  performed  using  command  scripts  provided  by  the  customer  and  reviewed  by  the 
validation  team.  See  Appendix  B  for  a  complete  listing  of  the  processing  options  for  this 
implementation.  It  also  indicates  the  default  options.  The  options  invoked  explicitly  for  validation 
testing  during  this  test  were: 

INPUT 

SUBLIBRARY 

SAVELIST 

SOURCESAVE 

(explanations  of  the  above  are  given  in  Appendix  B). 

Test  output,  compiler  and  linker  listings,  and  job  logs  were  captured  on  magentic  tape  and  archived 
at  the  AVF.  The  listings  examined  on-site  by  the  validation  team  were  also  archived. 
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APPENDIX  A 

MACRO  PARAMETERS 

This  appendix  contains  the  macro  parameters  used  for  customizing  the  ACVC.  The  meaning  and 
purpose  of  these  parameters  are  explained  in  [UG89].  The  parameter  values  are  presented  in  two 
tables.  The  first  table  lists  the  values  that  are  defined  in  terms  of  the  maximum  input-line  length, 
which  is  the  value  for  $MAX_IN_LEN~also  listed  here.  These  values  are  expressed  here  as  Ada 
string  aggregates,  where  ”V"  represents  the  maximum  input-line  length. 

Macro  Parameter 

Macro  Value 

SMAXINLEN 

126 

$BIG_ID1 

A 

II 

> 

< 

A 

II 

H 

i 

> 

fH 

$BIG_ID2 

(1..V-1  =>  ’A’,  V  =>  ’2’) 

$BIG_ID3 

(1..V/2  =>  ’A’)  &  ’3’  &  (1..V-1-V/2  =>  ’A’) 

$BIG_ID4 

(1..V/2  =>  ’A’)  &  ’4’  &  (1..V-1-V/2  =>  ’A’) 

$BIG_INT_LIT 

(1..V-3  =>  ’O’)  &  "298" 

$BIG_REAL_LIT 

(1..V-5  =>  ’O’)  &  "690.0" 

SBIGSTRINGl 

’"’  &  (1..V/2  =>  ’A’)  &  ’"’ 

$BIG_STRING2 

&  (1..V-1-V/2  =>  ’A’)  &  T  &  ’"’ 

SBLANKS 

(1..V-20  =>  ”) 

SMAX  LEN  INT  BASED  LITERAL 

"2:"  &  (1..V-5  =>  ’O’)  &  "11:" 

SMAX_LEN_REAL_BASED. 

LITERAL 

"16:"  &  (1..V-7  =>  ’O’)  &  "F.E:" 

$MAX_STRING_LITERAL 

&  (1..V-2  =>  ’A’)  &  ’*’ 

The  following  table  lists  all  of  the  other  macro  parameters  and  their  respective  values. 
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Macro  Parameter 

Macro  Value 

$ACC_SIZE 

32 

SALIGNMENT 

4 

$COUNT_LAST 

131070 

$DEFAULT_MEM_SIZE 

16#FFFF_FFFF# 

$DEFAULT_STOR_UNIT 

8 

$DEFAULT_SYS_NAME 

VME_2900 

$DELTA_DOC 

2#1.0#E-63 

$ENTRY_ADDRESS 

ENT’ ADDRESS 

$ENTRY_ADDRESS1 

ENT  1’ ADDRESS 

$ENTRY_ADDRESS2 

ENT2’ADDRESS 

JFIELDLAST 

67 

$FILE_TERMINATOR 

»  » 

SFIXEDNAME 

NOSUCHTYPE 

$FLOAT_NAME 

NO_SUCH_TYPE 

$FORM_STRING 

JFORMSTRING2 

"CANNOTRESTR ICTFILEC  AP  ACITY" 

$GREATER_THAN_DURATION 

75000.0 

JGREATER  THAN  DURATION  BASE  LAST 

2#f.0#E44 

JGREATER  THAN  FLOAT  BASE_LAST 

8.0E+75 

JGREATER  THAN  FLOAT  SAFE  LARGE 

1 6#0 .  FFFF_FFFF_FFFF_FO  #  E63 

JGREATER  THAN  SHORT  FLOAT  SAFE  LARGE 

r6#0.FFFF_FC#E63 
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$HIGH_PRIORITY 

63 

$  ILLEG  AL_EXTE  RN  AL_FILE_N  AME 1 

<NOT-A-VME-FILENAME> 

$ILLEGAL_EXTERNAL_FTLE_NAME2 

[ANOTHER-BAD-VME-FILENAME] 

$INAPPROPRIATE_LINE_LENGTH  4096 

$INAPPROPRIATE_PAGE_LENGTH 

-1 

$INCLUDE_PRAGMA1 

PRAGMA  INCLUDE  ("A28006D1.ADA") 

$INCLUDE_PRAGMA2 

PRAGMA  INCLUDE  ("B28006D1.ADA") 

$INTEGER_FIRST 

-2147483648 

SINTEGERLAST 

2147483647 

$INTEGER_LAST_PLUS_1 

2147483648 

SENTE  RFACE_LANGUAGE 

S3 

$LESS_THAN_DURATION 

-75000.0 

SLESS  THAN  DURATION  BASE  FIRST 

-2#I.0#E45 

$LlNE_TERMINATOR 

*  » 

SLOW_PRIORITY 

0 

S  MACH  INE_COD  E_ST ATEMENT 

NULL; 

SMACHINE_CODE_TYPE 

NO_SU  CH_TYPE 

SMANTISSA_DOC 

63 

SMAXDIGITS 

18 

SMAXINT 

9223372036854775807 

SMAXENTPLUSI 

9223372036854775808 

SMININT 

-9223372036854775808 
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SNAME 

$NAME_LIST 

$NAME_SPECIFIC ATION 1 

$NAME_SPECIFICATION2 

$NAME_SPECIFICATION3 

$NEG_BASED_INT 

S  NE  WMEMS IZE 

$NEW_STOR_UNIT 

$  NE  W_S  Y S_N  AME 

SPAGETERMINATOR 

SRECORDDEFINITION 

$RECORD_NAME 

STASKjSIZE 

$TASK_STORAGE_SIZE 

STICK 

SVARIABLE_ADDRESS 

$VARIABLE_ADDRESS1 

$VARIABLE_ADDRESS2 

SYOUR_PRAGMA 


NO_SUCH_TYPE_ AVAILABLE 
VME_2900 

:ADAVAL.X2120A(1,*,1) 

:ADAVAL.X2120B(1,M) 

:ADAVAL.X3119A(1,*,1) 

16#FFFF_FFFF_FFFF_FFFE# 

16#FFFF_FFFF# 

8 

VME  2900 
ASCII. FF 
NEW  INTEGER; 

NO_SUCH_MACHINE_CODE_TYPE 
32 
8192 
0.000002 
VAR’ADDRESS 
VAR1 'ADDRESS 
VAR2’ ADDRESS 
INTERFACE_SPELLING 
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APPENDIX  B 

COMPILATION  SYSTEM  OPTIONS 


The  compiler  options  of  this  Ada  implementation,  as  described  in  this  Appendix,  are  provided  by  the 
customer.  Unless  specifically  noted  otherwise,  references  in  this  appendix  are  to  compiler 
documentation  and  not  to  this  report. 
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I  CL 

SECURE 

SYSTEMS 


ADA 

DEVELOPMENT 

UNIT 
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D3  ADACOMPILE 
ADA 


Summary 

The  ADA_COMP I LE  command  is  used  to  compile  one  or  more  Ada 
compilation  units. 

ADA_COMP I LE  ( 

8 literal! 

8 literal! 

8 literal 8 
8superliteral8 
8 literal 8 
81iteral8 
8 boolean! 

8int8 
8 boolean! 

8 literal 8 
8superliteral8 
8 boolean! 

8 response! 


INPUT, 

SUBLIBRARY 
SAVELI ST  :  = 

LISTINGS  : =SOURCE , 

CONFIG  :  = 

TEST  s  =  " " , 

PROGRESS  : = FALSE , 

UNIT_ID  :  =-l , 

SOURCESAVE  : =TRUE , 

SUPPRESS_CHECKS  :="N0", 
OPTIMISE  :  = 

DEBUG  : = FALSE , 

RESPONSE  : = RESULT ) 


Parameter  details 


Keyword 

INPUT 


Default 


Name  of  file  (in  any  VME  format)  Mandatory 
containing  the  input  to  the  compiler. 

The  file  may  hold  one  or  more 
compilation  units. 


Must  not  be  *STDAD. 


SUBLIBRARY  Specifies  the  current  sublibrary  and  Null 
thereby  also  the  current  library  which 
consists  of  the  current  sublibrary  and 
its  ancestor  sublibraries  (see  Section 
2.1).  The  name  may  be  up  to  16 
characters . 


If  the  parameter  is  defaulted  the 
sublibrary  designated  by  the  JSV 
I CL9ADA2 SUBLIBRARY  is  used  as  the 
current  sublibrary. 


I  CL 

SECURE 

SYSTEMS 


ADA 

DEVELOPMENT 

UNIT 


Refs  ADAADM.VA3.4 

Issues  1 

Pages  77  of  114 


SAVELI ST 


LISTINGS 


CONFIG 


TEST 


PROGRESS 


UNIT  ID 


Name  of  permanent  VME  file  to  hold  the  Null 
compilation  listing.  This  must  not  be 
greater  than  38  characters. 

Alternatively  the  name  of  a  library 
followed  by  a  full  stop  may  be 
specified.  In  this  case  the  filename  is 
the  terminal  part  of  the  input  file  name 
and  the  complete  name  must  not  be 
greater  than  38  characters. 

If  absent,  a  temporary  file  is  created, 
the  name  of  which  is  the  source  file 
terminal  name  prefixed  by  " ICL9ADA2LF " . 

This  means  that  the  source  file  terminal 
name  must  not  be  greater  than  22  chars. 

Listings  required:  SOURCE 

SOURCE,  OBJECT,  XREF. 

A  value  of  "NONE”  will  suppress  the 
compilation  listing. 

Name  of  VME  file  holding  configuration  Null 
information  (see  4.4). 

If  absent  a  standard  configuration  file 
is  used. 


Literal  controlling  production  of  Null 

diagnostic  listings  and  conditional 

compilation.  This  parameter  should  only 
be  used  at  the  request  of  the  Ada 
Development  Unit. 

Boolean  controlling  the  issue  of  FALSE 

progress  messages. 

A  value  of  TRUE  will  cause  messages  to 
be  generated  on  the  user's  terminal  as 
the  passes  are  entered. 

Integer  controlling  the  unit  number  of  -1 
the  compiled  program  unit.  (See  2.4.2.) 

If  the  compilation  contains  more  than 
one  program  unit,  UNIT_ID  applies  only 
to  the  first. 

Of  use  when  incorporating  non-Ada  Code. 

The  default  value  of  -1  causes  the 
compiler  to  select  a  suitable  unit 
number. 


I  CL 

SECURE 

SYSTEMS 


SOURCESAVE 


SUPPRESS 

CHECKS 


OPTIMISE 

DEBUG 

RESPONSE 
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A  value  of  TRUE  will  cause  the  source  TRUE 
text  of  the  compilation  unit  to  be 
stored  in  the  program  library.  If  the 
source  text  file  has  several  compilation 
units  the  source  text  for  each 

compilation  unit  will  be  stored. 

The  source  is  not  stored  if  there  is  an 
error  in  the  compilation  unit. 

The  source  texts  stored  in  the  library 
can  be  extracted  (or  inspected)  using 
the  Program  Library  Utility. 

A  value  of  FALSE  means  that  the  source 
is  not  stored  in  the  library. 

A  value  of  “NO"  will  cause  code  to  be  "NO" 
generated  to  do  the  checking  described 
in  the  LRM. 

A  value  of  "YES"  pecifies  that  no 
checking  should  be  performed  at  run 
time. 

This  parameter  has  no  effect.  Null 

A  value  of  TRUE  will  cause  information  FALSE 
to  be  generated  for  the  debugger. 

A  value  of  FALSE  specifies  that  no  such 
information  should  be  generated. 

Specifies  the  name  of  a  JSV  which  will  RESULT 
contain  the  result  of  the  command  call. 
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LINKER  OPTIONS 

The  linker  options  of  this  Ada  implementation,  as  described  in  this  Appendix,  are  provided  by  the 
customer.  Unless  specifically  noted  otherwise,  references  in  this  appendix  are  to  linker  documentation 
and  not  to  this  report. 
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D4  ADALINK 
Su— ary 

ADALINK  is  invoked  to  produce  an  executable  program  from  the 
current  program  library. 


ADA  LINK  ( 

# literal # 

MAINUNIT, 

SliteralS 

SUBLIBRARY 

.  —  H  H 
*  , 

SliteralS 

COLLECTLIB, 

SliteralS 

TAG, 

•  s  «  « 

*  , 

@ literal? 

SAVELIST 

9 boolean# 

DEBUG 

: = FALSE , 

Sliteral# 

DETAILS 

:="N", 

0 literal# 

EXTRACOMMANDS 

.  —  MM 

•“  r 

# integer# 

TEST 

:=0, 

# response# 

RESPONSE 

: “RESULT  ) 

Par 


ter  details 


Keyword 

MAINUNIT 

SUBLIBRARY 


Use, options  and  effect 


Default 


Specifies  the  main  program  which  must  be  Mandatory 
a  library  unit  of  the  current  library, 
but  not  necessarily  of  the  current 
sublibrary. 


Specifies  the  current  sublibrary  and  Null 
thereby  also  the  current  library  which 
consists  of  the  current  sublibrary  and 
its  ancestor  sublibraries  (see  Section 
2.1).  The  name  may  be  up  to  16 
characters . 


If  the  parameter  is  defaulted  the 
sublibrary  designated  by  the  JSV 
ICL9ADA2 SUBLIBRARY  is  used  as  the 
current  sublibrary. 


COLLECTLIB  Specifies  the  name  of  the  OMF  library  in  Mandatory 
which  the  Ada  program  will  be  stored. 

The  filename  used  will  be: 


<main  program  name>MOD 


with  an  entry  name  of: 

<main  program  name>. 
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TAG 

SAVELI ST 


DEBUG 

DETAILS 


EXTRACOMMANDS 

TEST 

RESPONSE 


This  parameter  is  used  to  form  the  names  Main 
of  both  the  OMF  library  to  be  created  to  program 
hold  the  Ada  modules  required  for  the  name 
name  ( ICL9ADA20MF<tag>)  and  the 

Collector's  command  file 

( ICL9ADA20PT<tag> ) .  After  successful 
collection  these  are  deleted.  They 
remain  only  if  the  collection  fails  or 
is  not  attempted. 

Specifies  the  name  of  the  file  to  hold  Null 
the  information  produced  by  the  linker 
( see  section  5.2). 

If  absent  and  provided  the  DETAILS  or 
TEST  parameter  is  used  a  file 
N ICL9ADA2LINKLOG "  will  be  used  and 
automatically  listed,  and  deleted. 

Output  from  the  Collector  is  sent  to  a 
separate  workfile  which  is  deleted 
unless  a  failure  occurs. 

A  value  of  TRUE  will  cause  information  FALSE 
to  be  generated  for  the  debugger. 

A  value  of  FALSE  specifies  that  no  such 
information  should  be  generated. 

Specifies  the  amount  of  information  the  NNN 
linker  will  output  on  the  optional  log 
file. 

By  default  only  error  messages  and  a 
short  summary  are  output.  With  DETAILS 
_  *y” t  "y"  or  any  string  starting  with 
these  characters  more  information  from 
the  linking  process  is  output. 

A  more  precise  description  of  the  output 
is  found  in  Section  5.2. 

Specifies  a  file  containing  minor  Null 
commands  which  will  be  added  to  the 
command  file  supplied  to  the  Collector. 

This  parameter  should  only  be  used  as  0 
advised  by  the  Ada  Development  Unit. 

Specifies  the  name  of  a  JSV  which  will  RESULT 
contain  the  result  of  the  command  call. 
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The  only  allowed  implementation  dependencies  correspond  to  implementation-dependent  pragmas, 
to  certain  machine-dependent  conventions  as  mentioned  in  Chapter  13  of  the  Ada  Standard,  and  to 
certain  allowed  restrictions  on  representation  clauses.  The  implementation-dependent  characteristics 
of  this  Ada  implementation,  as  described  in  this  Appendix,  are  provided  by  the  customer.  Unless 
specifically  noted  otherwise,  references  in  this  Appendix  are  to  compiler  documentation  and  not  to 
this  report.  Implementation-specific  portions  of  the  package  STANDARD  are  presented  on  the 
following  three  pages. 


Validitfan  Suaary  Report 


International  Computers  Halted 


Appendix  C  -  Papa  1  of  1 


AVFVSR  90502/31 
VME  Ada  Coapiler  VA3.00 


I  CL 

SECURE 

SYSTEMS 


ADA 


DEVELOPMENT 

OMIT 


Ref*  ADAADM.VA3 .4 

Issues  3 

Pages  96  of  118 


APPENDIX  F  Implementation  Dependent  Characteristics 

The  following  sections  describe  the  implementation 
dependent  characteristics  of  the  compiler. 

Sections  F2  onwards  address  the  topics  given  in  the 
Appendix  F  of  the  Ada  Language  Reference  Manual  (ANSI/ 
MIL-STD-1815A) ,  except  for  topic  (5),  which  is  rot 
relevant  since  implementation*-  generated  names  for 
implementation-dependent  components  are  supported  by  this 
compiler. 

FI  Predefined  Types 

This  section  describes  the  implementation-dependent 
predefined  types  declared  in  the  predefined  package 
STANDARD  (cf.  [LRM]  Annex  C)f  and  the  relevant  attributes 
of  these  types. 

Integer  Types 

Two  predefined  integer  types  are  implemented,  INTEGER  and 
LONG  INTEGER. 


They  have  the  following  attributes: 


INTEGER ' FIRST 
INTEGER 'LAST 
INTEGER 'SIZE 


2_147_483_648 
2_147  483_647 
32 


LONG_INTEGER' FIRST  -  -16:8000_0000_0000_0000: 
LONG_INTEGER ' LAST  -  1 6  *  7 FFF_FFFF_FFFF_FFFF * 
LONG  INTEGER' SIZE  *  64 


Floating  Point  Types 


Three  predefined  floating  point  types  are  supported, 
SHORT_FLOAT,  FLOAT  and  LONG  FLOAT. 


They  have  the  following  attributes: 


SHORT  FLOAT 'DIGITS 
SHORTJPLQAT ' FIRST 
SHORT  FLOAT 'LAST 
SHORT_FLOAT 'SIZE 
SHORT_FLOAT ' SAFE_SMALL 
SHORT_FLOAT ' SAFE_LARGE 
SHORT_FLOAT ' SAFE_EMAX 
SHORT_FLOAT ' MACHINE  RADIX 
SHORT_FLOAT ' MACHINE  MANTISSA 
SHORT_FLOAT ' MACHINE~EMAX 
SHORT  FLOAT ' MACH I NE_EMI N 
SHORT~FLOAT ' MACHINE_ROUNDS 
SHORT  FLOAT 'MACHINE  OVERFLOWS 


6 

16:0. FFFF_FF : E63 
16:0.FFFF__FF:E63 
32 

2:1.0:E-253 


16:0. FFFF  F8:E63 
252 
16 
6 
63 


-64 


FALSE 

FALSE 
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FLOAT 'DIGITS 
FLOAT 'FIRST 
FLOAT 'LAST 
FLOAT 'SIZE 
FLOAT ' SAFE_SMALL 
FLOAT ' SAFE_LARGE 
FLOAT '  SAFE_EMAX 
FLOAT ' MACHINE_RADIX 
FLOAT ' MACHINE_MANTISSA 
FLOAT ' MACHINE_EMAX 
FLOAT '  MACHINE_EMIN 
FLOAT ' MACHINE_ROUNDS 
FLOAT 'MACHINE  OVERFLOWS 


-16:0. FFFF_FFFF_FFFF_FF : E6  3 
16 :0 .FFFF  FFFF  FFFF  FF:E63 
64  “ 

2:1.0:E-253 

16:0. FFFF  FFFF  FFFF  E0:E63 
252 
16 
14 
63 
-64 
FALSE 
FALSE 


LONG_FLOAT' DIGITS  *  18 

LONG_FLOAT ' FIRST 

-16:0. FFFF_FFFF_FFFF_FFFF  FFFF  FFFF  FFFF:E63 
LONG_FLOAT ' LAST 

16:0. FFFF_FFFF_FFFF_FFFF_FFFF  FFFF  FFFF:E63 
LONG_FLOAT ' SIZE  >128 

LONG_FLOAT ' SAFE_SMALL  «  2:1.0:E-253 

LONG_FLOAT ' SAFE_LARGE 

16:0.  FFFF__FFFF_FFFF_FFF8_0 0 0 0_0 0 0 0_0 000 :  E63 
LONG_FLOAT ' SAFE_EMAX  “  »_252 

LONG_FLOAT ' MACHINE_RADIX  -  16 

LONG_FLQAT '  MACHINE_MANTISSA  >  28 

LONG_FLOAT ' MACH I NE_EMAX  -  63 

LONG_FLOAT ' MACHINE_EMIN  >  -64 

LONG_FLOAT ' MACHINE_ROUNDS  >  FALSE 
LONG  FLOAT 'MACHINE  OVERFLOWS  -  FALSE 


Fixed  Point 


Two  kinds  of  anonymous  fixed  point  types  are  supported; 
FIXED  and  LONG_FIXED  occupying  32  and  64  bits 
respectively  with  the  characteristics: 


FIXED 'FIRST  -  -2  147  483  648 

FIXED 'LAST  -  2_147~483_647 

FIXED' SIZE  -  32 

FIXED 'MACHINE  ROUNDS  >  FALSE 

FIXED ' MACHINE  OVERFLOWS  -  TRUE 


LONG_FIXED' FIRST 
LONG_FIXED ' LAST 
LONG_FIXED' SIZE 
LONG_FIXED ' MACH I NE_ROUNDS 
LONG" FIXED 'MACHINE  OVERFLOWS 


-16:8000  0000  0000_0000: 
16 : 7FFF~FFFF~FFFF  FFFF : 
64 

FALSE 

TRUE 


DURATION 


The  predefined  fixed  point  type  DURATION  is  supported  and 
has  the  following  attributes: 


-  -2:1.0:E44 

-  16 : 0FFF_FFFF  FFFF . FFFFE : 

-  2.0E-6 


DURATION 'FIRST 
DURATION 'LAST 
DURATION 'DELTA 


DURATION ' SMALL  -  2:1.0:E-19 

DURATION ' SMALL_POWER  »  -19 

DURATION' SIZE  -  64 

DURATION' MACHINE  ROUNDS  «  FALSE 

DURATION ' MACHINE  OVERFLOWS  »  TRUE 


DURATION 'LARGE 
DURATION 'FORE 
DURATION 'AFT 
DURATION ' MANTISSA 
DURATION ' SAFE_LARGE 
DURATION 'SAFE  SMALL 


DURATION 'LAST 
15 
6 

63 


DURATION 'LARGE 
DURATION 'SMALL 


F2  Pragmas 

F2 . 1  Language  Defined  Pragmas 

This  section  lists  all  language  defined  pragmas  and 
restrictions  on  their  use  and  effect  as  compared  to 
explanation  given  in  the  [LRM] .  Pragmas  which 
innapropriate  to  the  compiler  are  described  as 
applicable". 


Pragsui  CONTROLLED 
Not  applicable. 
Pragma  ELABORATE 
As  in  the  [LRM]. 


Pragma  INLINE 
Not  applicable. 

Pragma  INTERFACE 

Supported  for  S3  ( see  section  7.3). 

Pragma  LIST 
As  in  the  [LRM]. 

Pragma  MEMORY  SIZE 


any 

the 

are 

Not 


Not  Supported,  cf.  SYSTEM  JHAME 
Pragma  OPTIMIZE 
Not  applicable. 
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Pragma  PACK 

In  the  absence  of  any  other  representation  clauses  on  the 
type,  the  effect  of  pragma  PACK  on  a  composite  type  will 
be: 


For  arrays 

a)  BOOLEAN  and  other  bit-sized  elements  will  be  packed 
one  per  bit. 

b)  other  integer,  fixed  and  enumeration  types  will  be 
packed  as  tightly  as  possible  (using  their  minimum 
sizes)  with  the  proviso  that  no  byte  contains  more 
than  one  element. 

c)  floating  point,  access  and  task  types  occupy  their 
predefined  sizes 

d)  array  and  record  elements  occupy  their  already 
calculated  sizes,  ie  packed  if  requested  on  the 
component  type,  or  obeying  any  other  size 
specifications  on  the  component  type. 

For  records 


a)  inter-component  gaps  will  be  less  than  a  byte. 

b)  BOOLEAN  and  other  bit-sized  components  will  be 

packed  one  per  bit. 

c)  other  integer,  fixed  and  enumeration  types  will  be 
packed  as  tightly  as  possible  (using  their  minimum 
sizes)  with  the  proviso  that  no  byte  contains  more 
than  one  component. 

d)  floating-point,  access  and  task  types  occupy  their 
pre-de fined  sizes. 

e)  array  and  record  elements  occupy  their  already 

calculated  sizes,  ie  packed  if  requested  on  the 

component  type,  or  obeying  any  other  size 

specifications  on  the  component  type. 

If  the  user  wants  any  tighter  packing,  this  should  be 
done  by  the  use  of  other  representation  clauses. 

If  the  record  also  has  a  rep  clause,  fields  not 
mentioned  in  the  rep  clause  will  be  allocated 

according  to  the  above  rules. 

Pragma  PAGE 


As  in  the  [LRM] . 
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Pragma  PRIORITY 
Mot  applicable. 

Pragma  SHARED 
Mot  applicable. 

Pragma  STORAGE  UNIT 
Has  no  effect. 

Pragma  SUPPRESS 

The  implementation  only  supports  the  following  form  of 
the  pragmas 

pragma  SUPPRESS  (identifier); 

where  identifier  ia  as  defined  in  [LRM]  section  11.7. 
i.e.,  it  is  not  possible  to  restrict  the  omission  of  a 
certain  check  to  a  specified  name. 

Pragma  SYSTEM  NAME 

Not  supported.  The  only  meaningful  SYSTEM_NAME  is 
VME_2900  when  using  the  VME  Ada  Compiler. 

F2.2  Implementation  Defined  Pragmas 

The  following  implementation  defined  pragmas  are 
supported! 

Pragma  IHTKRFACE_SPELLING 

The  permitted  syntax  is  as  follows: 

pragma  INTERFACE_SPELLING  ( name ,  " S3 -name  " ) ; 

This  is  used  in  conjunction  with  pragma  INTERFACE  (S3)  and 
indicates  that  no  body  exists  for  the  Ada  subprogram  name 
and  an  S3  procedure  S3 -name  will  be  expected  by  the 
linker. 

The  use  of  pragma  INTERFACE_SPELLING  will  also  ensure 
that  the  S3  name  is  a  valid  S3  external  name  (i.e.  less 
than  or  equal  to  32  alphanumeric  characters,  of  which  the 
first  is  alphabetic  and  all  are  upper  case) . 


The  permitted  syntax  is  as  follows s 
pragma  MAIN  (name); 


Indicates  to  the  System  Linker  that  the  library 
subprogram  name  is  a  main  program,  (see  also  section  5.3) 
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Pragma  COMMON 

The  permitted  syntax  is  as  follows: 

pragma  COMMON  (name,  omf-name ); 

Indicates  to  the  System  Linker  that  the  library  unit  name 
is  to  be  a  "visible"  name  in  the  OMF  module  omf-name,  and 
can  therefore  be  referenced  from  any  program  forming  part 
of  the  "system",  (see  also  section  5.3) 

Pragma  BASE 

The  permitted  syntax  is  as  follows: 
pragma  BASE  ( name ) ; 

This  is  used  to  extend  a  system  definition,  and  name  is 
the  package  containing  the  system  definition  or  extended 
system  definition  to  be  extended,  (see  also  section  5.3) 

F3  Attributes 

The  following  implementation  defined  attributes  are 
provided: 

P' DESCRIPTOR  for  a  prefix  P  that  denotes  an  object: 

Yields  the  VMS  descriptor  to  the  object. 
The  value  of  this  attribute  is  of  the  type 
DESCRIPTOR  defined  in  the  package  SYSTEM. 

The  type /bound  word  of  the  descriptor  has 
the  following  format: 

for  INTEGER,  FIXED,  SHORTJPLQAT ,  TASK, 
ACCESS,  ENUMERATION  (including  BOOLEAN  and 
CHARACTER) :  type  *  word;  bound  *  1 

for  LONG.INTEGER,  LONG_FIXED,  FLOAT:  type 
■  long  word;  bound  -  1 

for  LONG_FLQAT :  type  *  long  long  word; 
bound  *  1 

for  records:  type  -  string  (not  byte- 
vector);  bound  -  size  of  record  in  bytes 

for  unpacked  arrays  of  records:  type  * 

string;  bound  *  record  size  in  bytes  * 
total  number  of  elements 

for  unpacked  arrays  of  unconstrained 
records:  type  *  string;  bound  ■  (record 

size  in  bytes  +  size  of  red  tape  in  bytes) 
*  total  number  of  elements 
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for  other  unpacked  arrays :  as  above 

depending  on  element  type;  bound  *  total 
number  of  elements 

for  packed  arrays  of  BOOLEAN:  type  3  bit; 
bound  3  total  number  of  elements 

for  packed  arrays  of  CHARACTER  (e.g. 
STRING):  type  3  byte;  bound  3  total  number 
of  elements. 

P ' FULL_ADDRESS  for  a  prefix  P  that  denotes  an  object: 

This  attribute  is  the  same  as  the 
predefined  attribute  'ADDRESS  except  for 
objects  (not  parameters)  which  are 
unconstrained  discriminated  records,  in 
which  case  this  attribute  yields  the 
address  of  the  first  storage  unit  of  the 
red  tape  area  which  precedes  the  actual 
record  data. 

P'FULL_SIZE  for  a  prefix  P  that  denotes  an  object: 

This  attribute  is  the  same  as  the 
predefined  attribute  'SIZE  except  for 
objects  which  are  unconstrained 
discriminated  records,  in  which  case  this 
attribute  yields  the  total  size  of  the 
record  including  the  red  tape  area  which 
precedes  the  actual  record  data. 

for  a  prefix  P  that  denotes  a  type: 

This  attribute  yields  the  same  value  as  the 
attribute  when  applied  to  an  object  of  that 
type. 

P' EBCDIC  IMAGE  for  a  prefix  P  that  denotes  a  discrete 

type  or  subtype: 

The  attribute  is  the  same  as  the  predefined 
attribute  'IMAGE  except  that  the  result 
type  is  the  type  STRING  declared  in  package 
EBCDIC. 

P' EBCDIC  VALUE  for  a  prefix  P  that  denotes  a  discrete 

type  or  subtype: 

The  attribute  is  the  same  as  the  predefined 
attribute  'VALUE  except  that  the  actual 
parameter  must  be  a  value  of  the  type 
STRING  declared  in  package  EBCDIC. 
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Package  SYSTEM  is 


type  ADDRESS  is  new  INTEGER; 

subtype  DESCRIPTOR  is  LONG_INTEGER; 
type  RESPONSE  is  new  INTEGER; 
subtype  PRIORITY  is  INTEGER  range  0..63; 
type  NAME  is  (VME_2900); 

SYSTEM_NAME :  constant  NAME  :=  VME_2900; 

STORAGE_UNIT :  constant  : =  8; 

MEMORY_SIZE:  constant  :*  2:1:E32  -  1; 

MIN_INT:  constant  :*  -16 : 8000_0000_0000_0000: ; 

MAX  INT:  constant  16 : 7FFF_FFFF_PFFP_FFFF : ; 

MAX_DIGITS :  constant  :*  18; 

MAX_MANTISSA:  constant  :>  63; 

PINE_DELTA:  constant  :»  2sl.0:E-63; 

TICK:  constant  :«  0.000_002; 

type  I NTE RF AC E_LANGU AGE  is  (S3); 

end  SYSTEM; 

The  definitions  of  ADDRESS  and  DESCRIPTOR  are  liable  to 
change  in  future  releases  and  for  forward  compatibility 
should  be  treated  as  if  they  were  private  types. 


A  following  package  for  the  purpose  of  manipulating 
textual  data  held  in  EBCDIC  format  is  provided: 


package  EBCDIC  is 


type  CHARACTER  is 


(  NUL, 

SOH, 

STX, 

ETX, 

E04 , 

HT, 

E06, 

DEL, 

E08, 

E09 , 

BOA, 

VT, 

FP, 

CR, 

SO, 

SI, 

DLB, 

DC1, 

DC  2 , 

DC  3 , 

E14, 

NL, 

BS, 

E17, 

CAN, 

EM, 

E1A, 

BIB, 

FS, 

GS, 

RS, 

US, 

MS, 

MNL, 

VP, 

E23, 

E24, 

LF, 

STB, 

ESC, 

E28, 

B29, 

E2A, 

E2B, 

B2C, 

ENQ, 

ACK, 

BEL, 

E30, 

B31, 

SYN, 

E33, 

E34, 

B35, 

E36, 

EOT, 

E38, 

B39 , 

E3A, 

B3B, 

DC4, 

NAK, 

E3E, 

SUB, 

9  9 

9 

B41, 

B42 , 

E43, 

E44, 

E45, 

E46, 

E47, 

E48, 

E49, 

'['» 

9  9 

•  9 

'1', 

B51, 

E52, 

E53, 

ES4, 

E5S, 

ES6, 

E57, 

E58, 

E59, 

')'/ 

*  •  9 

9  9 

0  +  9 

9 

9  —  9 

9 

'/', 

E62, 

E63, 

E64, 

E65, 

E66, 

E67, 

E68, 

B69 , 

'1'. 

9  9 

9  9 

9  9 

9 

'?', 

E70, 

E71, 

E72, 

E73, 

E74, 

E75, 

E76, 

E77  , 

E78, 

9  %  9 

9 

'i'. 

9  9  9 

9 

9  m  9 

9 

9*9 

9 

E80, 

'a' , 

'b'. 

'c'. 

'd'. 

'er, 

' f 

'g'/ 

'h'. 

'i'f 

E8A, 

E8B, 

E8C, 

E8Df 

E8E, 

E8F, 

E90, 

•v. 

'1', 

'm'. 

'n'. 

'o'. 

'P'/ 
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'q'* 

'r'. 

E9A, 

E9B, 

E9C, 

E9D, 

E9E, 

E9F, 

EAO , 

»  -  I 

1 

'S'  # 

L  1 

'u'. 

'v'. 

'w' , 

'x'. 

'Y' ' 

'z' , 

EAA, 

EAB, 

EAC, 

EAD, 

EAE, 

EAF, 

EBO, 

EB1, 

EB2 , 

EB3 , 

EB4 , 

EB5, 

EB6, 

EB7, 

EB8 , 

EB9 , 

EBA, 

EBB, 

EBC, 

EBD, 

EBE, 

EBF, 

'A', 

'B', 

'C', 

'D', 

'E', 

'F', 

'G', 

'H', 

'I', 

ECA, 

ECB, 

ECC, 

BCD, 

ECE, 

ECF, 

•y . 

'J', 

'K', 

'L', 

'M', 

'H', 

'O', 

'P'r 

'Q'/ 

'R'/ 

EDA, 

EDB, 

EDC, 

EDD, 

EDE, 

EDF, 

EE1, 

'S', 

'T', 

'U', 

'V', 

'W'  , 

'X', 

'Y', 

'Z', 

EEA, 

EEB, 

EEC, 

EED, 

EEE, 

EEF, 

'O', 

'1'/ 

'2', 

'3', 

'4', 

'5', 

'6', 

'7', 

'8', 

'9'# 

EPA, 

EFB, 

EFC, 

EFD, 

EFE, 

EFF  ); 

LJBracket 

• 

• 

constant 

CHARACTER 

•  a 

'['? 

Exclam 

• 

• 

constant 

CHARACTER 

:  = 

'  !  '  ; 

Ampersand 

: 

constant 

CHARACTER 

:* 

R_Bracket 

• 

• 

constant 

CHARACTER 

:> 

Dollar 

: 

constant 

CHARACTER 

•  a 

'S'; 

Semicolon 

i 

constant 

CHARACTER 

X* 

i  •  *  • 
9  9 

Circumflex 

: 

constant 

CHARACTER 

•  a 

/  A  /  # 

Bar 

s 

constant 

CHARACTER 

x* 

'1  '; 

Percent 

: 

constant 

CHARACTER 

s 

'%' ; 

Underline 

: 

constant 

CHARACTER 

•  ® 

9  #  • 

Query 

s 

constant 

CHARACTER 

X* 

'7' ; 

Grave 

s 

constant 

CHARACTER 

X* 

9  9  0 

Colon 

: 

constant 

CHARACTER 

X* 

'  i ' ; 

Pound 

: 

constant 

CHARACTER 

X  — 

'6'; 

At_Sign 

: 

constant 

CHARACTER 

X  9 

Quotation 

: 

constant 

CHARACTER 

•  a 

9  ••  9  • 

Tilde 

s 

constant 

CHARACTER 

X** 

9  *■  r  • 

L_Brace 

X 

constant 

CHARACTER 

•  ® 

'{'? 

R_Brace 

s 

constant 

CHARACTER 

X  * 

Back_Slash 

X 

constant 

CHARACTER 

I* 

'Vi 

FEO 

x  constant 

CHARACTER 

x» 

BS; 

— 

Back  Space 

FE1 

x  constant 

CHARACTER 

x« 

HT? 

— — 

Horizontal 

Tabulate 

FE2 

x  constant 

CHARACTER 

X* 

LF; 

— 

Line  Feed 

FE3 

x  constant 

CHARACTER 

X  - 

VT; 

— 

Vertical  Tabulate 

FE4 

x  constant 

CHARACTER 

X* 

FF; 

— 

Form  Feed 

FE5 

x  constant 

CHARACTER 

X  ■ 

CR; 

— 

Carriage  Return 

IS1 

x  constant 

CHARACTER 

X* 

US; 

Unit  Separator; 

IS2 

x  constant 

CHARACTER 

t  ■ 

RS; 

— 

Record  Separator 

IS3 

x  constant 

CHARACTER 

X* 

GS; 

— 

Group  Separator 

IS4 

x  constant 

CHARACTER 

:  ■ 

FS; 

— 

File  Separator 

TCI 

x  constant 

CHARACTER 

X* 

SOH; 

Start  of  Heading 

TC2 

x  constant 

CHARACTER 

x  * 

STX; 

— 

Start  of  Text 

TC3 

x  constant 

CHARACTER 

X* 

ETX; 

mmmt 

End  of  Text 

TC4 

x  constant 

CHARACTER 

X" 

EOT; 

End  of 

Transmission 

TC5 

x  constant 

CHARACTER 

X* 

ENQ; 

— 

ENQuiry 

TC6 

x  constant 

CHARACTER 

x» 

ACK; 

— 

Acknowledge 

TC7 

x  constant 

CHARACTER 

x» 

OLE; 

— 

Data  Link  Escape 

TC8 

x  constant 

CHARACTER 

X* 

NAK; 

Negative 

I  CL 

SECURE 

SYSTEMS 


ADA 

DEVELOPMENT 

UNIT 


Ref:  ADAADM.VA3.4 
Issue:  3 

Page:  105  of  118 


Acknowledge 

TC10  :  constant  CHARACTER  :=  ETB;  —  End  of 

Transmission  Block 


type  STRING  is  array ( POSITIVE  range  <>)  of  CHARACTER; 
pragma  PACK( STRING) ; 


— 

function 

(Left, 

Right  : 

STRING) 

return 

Boolean; 

— 

function 

"/*"  (Left, 

Right  : 

STRING) 

return 

Boolean; 

— 

function 

"<"  (Left, 

Right  : 

STRING) 

return 

Boolean; 

— 

function 

"<■•  (Left, 

Right  : 

STRING) 

return 

Boolean; 

— 

function 

->"  (Left, 

Right  : 

STRING) 

return 

Boolean; 

— 

function 

">*"  (Left, 

Right  : 

STRING) 

return 

Boolean; 

_  _ 

function 

(Left  : 

STRING; 

— 

Right  : 

STRING) 

return 

STRING; 

function 

(Left  : 

CHARACTER; 

— 

Right  : 

STRING) 

return 

STRING; 

function 

"S " (Left  : 

STRING; 

Right  : 

CHARACTER)  return  STRING; 

function 

(Left  : 

CHARACTER; 

— 

Right  : 

CHARACTER)  return  STRING; 

end  EBCDIC; 


F4 . 3  VMM  Interface  Package 

The  VME_IF  package  is  provided  to  permit  Ada  programs  to 
read  and  write  Job  Space  Variables,  to  read  the  real 
time  clock  and  to  determine  the  full  hierarchic  name  of 
local  names. 

This  package  uses  VMS  Compiler  Target  Machine  (CTM) 
procedures  and  while  it  is  intended  that  the  following 
descriptions  should  be  sufficient  for  most  purposes 
the  CTM  Manual  [CTM]  may  be  consulted  for  further 
details . 

F4.3.1  The  Ada  Specification  of  the  Package 

package  VME_IF  is 

type  VME_NUMERIC_TIME  is 
record 
TEAR, 

MONTH, 

DAT, 

HOUR, 

MINUTE, 

SECOND, 

MSEC_10  :  INTEGER; 
end  record; 
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—  MSEC_10  is  in  lOOths  of  a  second, 
subtype  VME_RESULT  is  INTEGER; 

--  zero  -  success. 

—  30461  -  the  JSV  does  not  exist. 

—  -9105  -  value  too  small ,  value  truncated. 

—  -9110  -  the  JSV  was  created  (so  will  not  be  visible 

on  return  from  the  Ada  program) . 

—  -9112  -  string  too  short,  name  truncated. 

subtype  VME_TIME  is  LONG_INTEGER ; 

procedure  VKE_NUKT I M_NOW  (TIME  *  out  VME_NUMERIC_TIME ; 

RES  :  out  VME_RESULT) ; 

—  TIME  -  the  current  date  and  time. 

—  RES  -  always  zero. 

procedure  VME_CPUTIME  (TIME  s  out  VME_TIME ; 

RES  :  out  VME_RESULT) ; 

—  TIME  -  the  process  time  in  microseconds 

—  RES  -  always  zero. 

procedure  VME_WAIT  TIME  (TIME  *  in  INTEGER; 

RES  *  out  VME_RESULT); 

—  TIME  -  the  delay  time  in  milliseconds  (N.B.  the  delay 

—  will  be  at  least  TIME). 

—  RES  -  zero,  indicating  that  the  delay  has  occurred. 

procedure  VME  GIVE  NAME  (LOCAL  i  in  STRING; 

FULL  t  out  STRING; 

LEN  :  out  INTEGER; 

RES  t  out  VME_RESULT) ; 

—  LOCAL  -  specifies  the  LOCAL  name. 

—  FULL  -  the  corresponding  full  hierarchic  name. 

—  LEN  -  the  length  of  the  name  in  the  string  FULL. 

—  RES  -  zero  or  -9112. 

procedure  VME_READ_STRING  (NAME  s  in  STRING; 

VALUE  t  out  STRING; 

LEN  *  out  INTEGER; 

RES  *  out  VME_RESULT) ; 

—  NAME  -  name  of  JSV. 

—  VALUE  -  contents  of  JSV  in  upper  case. 

—  LEN  -  the  length  of  the  contents  in  string  VALUE. 

—  RES  -  zero,  -9105  or  30461. 

procedure  VME_READ_BOOL  (NAME  t  in  STRING; 

VALUE  :  out  BOOLEAN; 

RES  :  out  VME_RESULT) ; 
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—  NAME  -  name  of  JSV. 

—  VALUE  -  value  of  JSV. 

--  RES  -  zero  or  30461. 

procedure  VME_READ_ I NT  (NAME  :  in  STRING; 

VALUE  :  out  LONG_INTEGER; 

RES  :  out  VME_RESULT) ; 

—  NAME  -  name  of  JSV. 

—  VALUE  -  value  of  JSV. 

—  RES  -  zero  or  30461. 

procedure  VMS  WRITE_STRING  (NAME  s  in  STRING; 

VALUE  s  in  STRING; 

RES  s  out  VME__RESULT)  ; 

—  NAME  -  name  of  JSV. 

— -  VALUE  -  value  to  be  written  to  JSV. 

—  RES  -  zero  or  >9110. 

procedure  VME_WRITE_BOOL  (NAME  :  in  STRING; 

VALUE  :  in  BOOLEAN; 

RES  :  out  VME_RESULT) ; 

—  NAME  -  name  of  JSV. 

—  VALUE  -  value  to  be  written  to  JSV. 

—  RES  -  zero  or  >9110. 

procedure  VME_WRITE_INT  (NAME  :  in  STRING; 

VALUE  t  in  LONG_INTEGER; 

RES  s  out  VME_RESULT) ; 

—  NAME  >  name  of  JSV. 

—  VALUE  >  value  to  be  written  to  JSV. 

—  RES  -  zero  or  >9110. 

procedure  VME_READ_STRING_KEEP_CASE 

(NAME  :  in  STRING; 

VALUE  s  out  STRING; 

LEN  s  out  INTEGER; 

RES  !  out  VME_RESULT) ; 

—  NAME  >  name  of  JSV. 

»  VALUE  >  contents  of  JSV. 

—  LEN  >  the  length  of  the  contents  in  string  VALUE. 

—  RES  -  zero,  >9105  or  30461. 

end  VME_IF; 

2  Using  The  Interface  Procedures 

All  of  these  procedures  return  a  VMS  RESPONSE  value  (in 
parameter  RES)  which  should  be  tested  for  zero  or  any  of 
the  specific  values  indicated  above;  other  positive 
values  indicate  that  a  VMS  error  has  occurred;  other 
negative  values  indicate  that  a  VMS  warning  has  occurred. 
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Job  Space  Variables  can  be  used  to  pass  information  into 
an  Ada  program  and  to  return  results.  Since  an  Ada 
program  is  bracketed  by  a  BEGIN  and  END  it  is  important 
to  realise  that  any  output  JSV's  need  to  be  declared  in 
the  outer  block  prior  to  entering  the  Ada  program. 

The  JSV  procedures  use  either  CTM_JS_READ  or  CTM_JS_WRITE 
[CTM]  and  automatically  convert  from~EBCDIC  to  ASCII  and 
vice  versa. 

Real  Time  Clock  Procedures 

The  value  returned  by  VME_CPUTIME  has  an  undefined  base, 
but  it  is  constant  for  all-calls  within  one  job,  thus  the 
difference  between  successive  calls  should  be  taken. 

The  real  time  clock  procedures  use  the  CTM_DATE_T I ME , 
CTM_PROC_TIME  and  CTM_WAIT_TIME  procedures  [CTM] . 

Give  Marne  Procedure 

This  uses  the  CTM_GIVE_NAME  procedure  [CTM] . 

F5  Representation  Clauses 
F5. 1  SIZE  specifications 

In  general,  a  size  specification  is  taken  to  be  the 
number  of  bits  to  be  allocated  to  objects  of  the  type, 
not  an  upper  bound. 

Integer,  enumeration  and  fixed  Types 

The  minimum  size  clause  allowed  for  a  discrete  or  fixed 
type  is  the  smallest  number  of  bits  required  to  hold  the 
range  of  values.  If  the  range  has  no  negative  values  then 
the  size  allowed  is  the  smallest  number  of  bits  to  hold 
the  unsigned  range.  Biased  representations  are  not  used. 

The  maximum  size  clause  allowed  for  an  integer  or  fixed 
type  is  64. 

The  maximum  size  clause  allowed  for  an  enumeration  type 
is  32 . 

Floating  Point  Types 

The  only  size  clauses  allowed  are  the  sizes  of  the  pre¬ 
defined  types,  ie  32,  64,  or  128. 

Array  Types 

For  a  constrained  array,  the  given  size  must  be  at  least 
as  large  as  the  (statically  determinable)  size  that  would 
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normally  be  used  for  the  array;  the  size  clause  will  not 
cause  packing. 

For  an  unconstrained  array  the  size  must  be  sufficient 
for  the  largest  values  of  all  the  index  subtypes  (again, 
these  must  be  static). 

Record  Types 

A  size  clause  for  a  record  does  not  cause  packing. 

The  given  size  must  be  at  least  as  large  as  the  size  that 
would  normally  be  allocated  for  the  record. 

Access  Types 

The  only  size  clause  allowed  is  32. 

Task  Types 

The  only  size  clause  allowed  is  32. 

F5 .2  STORAGE  SIZE  specifications 

Access  Types 

The  minimum  collection  size  allowed  is  12,  the  number  of 
storage  units  required  to  hold  necessary  housekeeping. 
The  maximum  collection  size  allowed  is  the  maximum  size 
of  an  area  allowed  by  VME.  The  value  is  rounded  up  to  a 
multiple  of  4. 

This  sets  the  collection  size,  it  includes  space  for 
housekeeping.  The  value  should  be  stored  in,  or  derived 
from,  the  collection  housekeeping  to  support  the 
attribute  of  the  same  name. 

For  an  access  type  that  has  not  been  given  a  collection 
size,  ' STORAGE_SIZE  returns  -1.  This  value  is  accepted  as 
a  collection  size  specification  and  indicates  that  a 
dynamic  sized  collection  is  to  be  used. 

Sized  collections  are  allocated  on  the  auxiliary  stack. 

Task  Types 

A  storage  size  of  a  task  includes  the  space  for  the 
control  stack  and  the  space  for  the  auxiliary  stack,  but 
doesn't  include  the  that  for  any  dependent  tasks. 

The  algorithm  for  dividing  the  space  between  the  two 
stacks  has  not  been  decided  yet.  The  maximum  and  minimum 
storage  sizes  allowed  will  be  affected  by  this  decision. 
The  maximum  control  stack  size  is  255  kbytes,  the  maximum 
auxiliary  stack  size  is  the  maximum  VME  area  size.  The 
size  will  be  rounded  up  to  a  multiple  of  8. 
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This  storage  size  value  can  be  interrogated,  and  so 
should  be  saved  somewhere  or  derived.  There  should  be  a 
default  value  and  some  means  of  setting  it. 

F5. 3  SMALL  specifications 

Any  positive  real  value  is  allowed  for  SMALL. 

If  SIZE  and  SMALL  specifications  are  inconsistent,  ie 
SIZE  too  small,  then  one  of  them  is  rejected. 

F5.4  Enumeration  representation  clauses 

The  range  of  enumeration  representation  codes  allowed  is: 

-2**31  ..  2**31-1 

Non-contiguous  enumeration  representation  codes  are 
allowed. 

If  size  and  enumeration  representation  clauses  are 
inconsistent,  ie  size  too  small,  then  one  of  them  is 
rejected. 

F5.5  Record  representation  clauses 

Composite  types  must  start  on  a  word  boundary. 

No  component  may  be  forced  to  start  on  a  non-byte 
boundary  if  to  do  so  means  it  would  occupy  all  or  part  of 
more  than  8  storage  units,  ie  bytes, 
e.g.  type  E  is  (El,  E2,  E3); 

for  E'SIZE  use  4; 
type  R  is 
record 
A  :  E; 

B  :  LONG_INTEGER; 
end  record;- 

for  R  use 
record 

A  at  0  range  0  ..  3; 

B  at  0  range  4  ..  67; 
end  record; 

This  would  be  rejected  as  B  would  occupy  parts  of  9 
storage  units  and  start  on  a  non-byte  boundary. 

The  only  values  allowed  for  the  alignment  clause  are  1,  2 
and  4.  If  a  component  for  which  a  component  clause  has 
been  given  has  subcomponents  with  alignment,  the 
'POSITION  part  of  the  clause  must  agree  with  the  highest 
subcomponent  alignment. 
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F6  Address  Clauses 

Address  clauses  are  only  supported  for  objects.  The 
value  for  an  address  can  only  be  the  result  of  an  ADDRESS 
attribute . 

Address  clauses  for  subprograms,  packages  task  units  and 
entries  are  not  supported. 

F7  Unchecked  Conversion 

Unchecked  conversion  is  only  allowed  between  objects  of 
the  same  size,  where  size  is  as  defined  in  section  7.1 
but  excluding  any  red-tape. 

For  dynamic  arrays  and  unconstrained  records,  the  size 
check  will  be  performed  at  run  time. 

The  TARGET  may  not  be  an  unconstrained  record.  If  the 
TARGET  is  an  unconstrained  array,  it  may  only  be  a  one¬ 
dimensional  array  of  scalar  type  with  an  index  type  of 
size  32  bits.  The  index  of  the  TARGET  array  will  start 
from  'FIRST  of  the  index  range. 

F8  Input-Output 

F8.1  Introduction 

This  implementation  supports  all  requirements  of  the  Ada 
language,  by  providing  an  interface  to  the  Series  39/VME 
file  system. 

This  section  describes  the  functional  aspects  of  the  VME 
file  system  interface,  for  the  benefit  of  systems 
programmers  that  need  to  control  VME  specific  Input- 
Output  characteristics  via  Ada  programs. 

The  section  is  organised  as  follows: 

Subsection  F8.2  discusses  the  requirements  of  Ada  Input- 
Output  systems  as  given  in  the  language  definition  and 
provides  answers  to  issues  that  are  not  precisely 
described  in  the  language  definition. 

Subsection  F8.3  describes  the  relation  between  (Ada) 
files  and  (VME)  external  files. 

Subsection  F8.4  describes  the  implementation  dependent 
FORM  parameter  of  OPEN  and  CREATE  procedures. 

The  reader  should  be  familiar  with  the  following 
documents : 


The  Ada  Language  Reference  Manual  [LRM] 
VME  Programmer's  Guide  [VME] 
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F8. 2  Clarifications  of  Ada  Input-Output  Requirements 

The  Ada  Input-Output  concepts  as  presented  in  chapter  14 
of  the  [LRM]  do  not  constitute  a  complete  functional 
specification  of  the  Input-Output  packages.  Some  aspects 
are  not  discussed  at  all,  while  others  are  deliberately 
left  open  to  an  implementation.  These  gaps  are  filled  in 
below,  with  reference  to  sections  of  the  [LRM] . 

The  range  of  the  type  COUNT  defined  in  package  DIRECT_IO 
is  0. .INTEGER 'LAST  and  in  TEXT  10  is  0.. 131070 


F8.2.1  Assumptions 

14.2.1(15)  For  any  RESET  operation,  the  content  of  the  file  is 
not  affected. 


14.2.1(7)  For  sequential  and  direct  input-ouput,  files 
created  by  SEQUENTIAL_IO  for  a  given  type  T,  may  be 
opened  (and  processed)  by  DIRECT_IO  for  the  same 
type  and  vice-versa,  if  the  VME  RAM  for  this 
external  file  supports  this  mode  of  operation.  In 
the  case  of  SEQUENTIAL_IO  access  the  function 
END_OF_FILE  (14.2.2(8))  may  fail  to  produce  TRUE  in 
the  case  where  the  file  has  been  written  at  random, 
leaving  "holes"  in  the  file. 

14.2.1(15)  For  any  attempt  to  overwite  an  existing  record  the 
replacement  record  must  be  the  same  size  as  the  one 
being  replaced. 


14.1(1)  An  external  file  is  any  VME  file,  which  may  be 
regarded  as  a  logical  collection  of  records. 


14.1(7)  An  external  named  file  created  on  a  filestore 
device  will  exist  after  program  termination,  and 
may  later  be  accessed  from  an  Ada  program. 


14.1(13)  See  Section  F.8.3.4  File-Access  and  Sharing. 


14.2.1(3)  The  name  parameter,  when  non-null,  must  be  a  valid 
VME  filename;  a  file  with  that  name  will  then  be 
created.  For  a  null  name  parameter,  a  temporary, 
unnamed  file  will  be  created. 


The  form  and  effect  of  the  form  parameter  is 
discussed  in  Section  F.8.4. 


14.2.1(13)  Deletion  of  a  file  is  only  supported  for  files  on  a 
disk  device,  and  requires  delete  permission  to  the 
file. 


14.6 


Package  LOW_LEVEL_IO  is  not  provided. 
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F8 . 3  Basic  File-Mapping 

Basic  file-mapping  concerns  the  relationship  between  Ada 
files  and  (formats  of)  external  VME  files,  and  the 
strategy  for  accessing  the  external  files. 

Below,  the  default  and  acceptable  file  formats  are 
summarised.  The  symbol  ES  is  used  to  denote  the  element 
size,  that  is,  the  number  of  bytes  occupied  by  the 
element  type,  or,  in  case  of  a  varying  size  type,  the 
maximum  size  (  which  must  be  determinable  at  the  point  of 
instantiation  from  the  value  of  the  SIZE  attribute  for 
the  element  type) . 

For  DIRECT_IO  and  SEQUENTIAL_IO,  when  a  successful 
connection  has  been  made  to  an  external  file,  an 
additional  check  is  made  that  the  record  size  of  the 
connected  file  is  suitable  for  the  element  size. 
USE_ERROR  is  raised  if  the  record  size  is  unsuitable. 

F8.3.1  DIRECT  10 

An  element  is  mapped  into  a  single  record  of  the  external 
file. 

For  CREATE  the  standard  file  description  *STDDIRECT  is 
used  by  default.  This  is  acceptable  provided  ES  *  80.  If 
ES  is  not  80  then  a  suitable  file  description  must  be 
created  (any  description  that  is  supported  by  the  direct 
serial  RAM  is  acceptable)  and  the  FORM  paramter  must  then 
be  used  to  specify  this  file  description. 

For  OPEN  the  file  specified  must  have  a  description  that 
is  supported  by  the  direct  serial  RAM,  and  a  record  size 
matching  the  element  size. 

F8.3.2  SEQUENTIAL  10 

An  element  is  mapped  into  a  single  record  of  the  external 
file. 

For  CREATE  the  standard  file  description  *STDM  is  used  by 
default.  This  is  acceptable  provided  ES  is  less  than  or 
equal  to  2036.  If  ES  is  greater  than  2036  then  a  suitable 
file  description  must  be  created  (any  description  that  is 
supported  by  the  serial  RAM  is  acceptable)  and  the  FORM 
paramter  must  then  be  used  to  specify  this  file 
description. 

For  OPEN  the  file  specified  must  have  a  description  that 
is  supported  by  the  serial  RAM. 
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F8.3.3  TEXT  10 

Lines  of  text  are  mapped  onto  records  of  external  files. 

The  default  files  provided  for  STANDARD_I NPUT  and 

STAND  ARD_OUTPUT  are  *STDAD  and  *STD0UT  respectively. 

For  output,  the  following  rules  apply. 

The  Ada  line  terminators  and  file  terminators  are  never 
explicitly  stored.  Page  terminators,  except  the  last, 
are  mapped  onto  a  FF  character  trailing  the  last  line  of 
the  page.  (In  particular,  an  empty  page  (except  the 
last)  is  mapped  onto  a  single  record  containing  only  a  FF 
character) .  The  last  page  terminator  in  a  file  is  never 
represented  in  the  external  file.  It  is  not  possible  to 
write  records  containing  more  than  2048  characters.  That 
is  ,  the  maximum  line  length  is  2047  or  2048,  depending 
on  whether  a  page  terminator  (  FF  character)  must  be 
written  or  not. 

On  input,  a  FF  trailing  a  record  indicates  that  the 
record  contains  the  last  line  of  a  page  and  that  at  least 
one  more  page  exists.  The  physical  end  of  file  indicates 
the  end  of  the  last  page. 

For  CREATE  the  standard  file  description  *STDM  is  used 
by  default.  This  is  acceptable  provided  ES  is  less  than 
or  equal  to  2036.  If  ES  is  greater  than  2036  and  less 
than  or  equal  to  2048  then  a  suitable  file  description 
must  be  created  (any  description  that  is  supported  by  the 
serial  RAM  is  acceptable)  and  the  FORM  paramter  must  hen 
be  used  to  specify  this  file  description.  Any  attempt  to 
input  or  output  a  record  containing  more  than  2048 
characters  will  raise  a  USE_ERR0R  exception. 

For  OPEN  the  file  specified  must  have  a  description  that 
is  supported  by  the  serial  RAM. 

F8.3.4  File-Access  and  Sharing 

In  this  section  a  characterisation  of  the  file-access 
used  is  given. 

OPEN  and  CREATE  procedures  use  the  normal  VME  defaulting 
mechanism  to  determine  the  exact  file  to  open  or  create. 
The  file  generation  number  (when  not  specified) ,  defaults 
(for  OPEN)  to  highest  existing,  or  (for  CREATE),  one 
higher  than  the  highest  existing  or  1  when  no  versions 
exist.  If  an  empty  string  is  specified  as  name,  CREATE 
will  create  a  workfile. 

External  files  will  be  accessed  via  standard  VMS  access 
methods.  For  SEQUENT  IAL_I0  and  TEXT_I0,  any  file 
description  supported  by  the  serial  RAM  is  acceptable, 
while  for  DIRECT__I0,  any  file  description  supported  by 
the  direct  serial  RAM  is  acceptable. 
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A  file  opened  with  mode  IN_FILE  will  allow  other 
processes  and,  indeed,  the  current  process  to  open  and 
read  the  file  (e.g.  as  IN_FILE  in  an  Ada  program).  For 
INOUT_FILE  or  OUT_FILE,  no  file  sharing  is  allowed,  in 
particular,  attempting  to  gain  write  access  to  such  an 
external  file  by  OPEN  or  RESET  will  raise  USE_ERROR. 

There  is  an  ablolute  VME  limit  of  255  on  the  number  of 
concurrent  file  connections.  Since  the  VME  System  uses  a 
number  of  system  files  the  limit  for  an  Ada  program  is 
somewhat  less  than  this.  This  absolute  limit  is  also  for 
sequential  files;  the  limit  for  index-sequential  files  is 
considerably  less. 

F8.4  Form  parameter 

The  FORM  string  parameter  that  can  be  supplied  to  any 
OPEN  or  CREATE  procedure,  has  the  intention  of  enabling 
control  over  external  file  properties  such  as  physical 
organisation,  allocation  etc.  In  the  present 
implementation,  this  is  acheived  by  a  combination  of  the 
name  and  form  parameters. 

Any  of  the  following  values  of  the  FORM  parameter  are 
permitted: 

(1)  Null 

(2)  LOCAL 

(3)  DESC»<fd> 

(4)  ALL-<fa> 

(5)  DESC»<fd>,ALL=<fa> 

(6)  DESC»<fd>, LOCAL 

(7)  ALL- <fa>, LOCAL 

(8)  DESC«<fd>,ALL»<fa>, LOCAL 

( 9 )  DESC«*STDFORM 

LOCAL  has  the  effect  of  causing  the  run  time  system  to 
treat  the  value  of  the  NAME  parameter  as  a  VME  local 
name. 


DESC  which  only  has  effect  on  a  CREATE  call,  specifies 
that  the  pre-existing  file  description  <fd>  should  be 
used.  A  new  file  description  can  be  set  up  using  the 
DESCRIBE_FILE  command  available  in  VME/B. 

ALL  which  only  has  effect  on  a  CREATE  call,  is  used  when 
the  file  allocation  to  be  used  is  required  to  be 
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different  from  the  default  allocation;  in  this  case  <fa> 
must  specify  a  pre-existing  file  allocation. 

The  special  form  parameter  ”DESCs*STDFORMM  when  supplied 
to  SEQUENT IAL_IO  will  provide  a  listing  workfile. 

All  letters  in  the  FORM  parameter  must  be  given  in  upper 
case,  and  only  the  first  32  bytes  of  the  form  parameter 
are  analysed.  If  the  syntax  is  incorrect  a  message  will 
be  sent  to  the  journal  but  no  exception  will  be  raised. 
No  semantic  validation  is  carried  out;  the  value  given 
will  be  passed  unmodified  to  VME  as  parameters  to  a  file 
creation  interface,  were  it  may  be  ignored  if  it 
conflicts  with  information  already  known  about  the  file, 
e.g  a  library  cannot  contain  two  files  with  different 
descriptions . 

F8.5  Additional  I/O  Packages 


No  additional  packages  are  provided. 


